home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / dev / misc / tddd2raw.lha / TDDD_to_Raw / TDDD_to_Raw.doc < prev    next >
Text File  |  1995-04-21  |  9KB  |  380 lines
  1.  
  2.  
  3.     TDDD to Raw 1.01
  4.  
  5.     © Copyright 1995 Jose M. Arnesto
  6.             
  7.  
  8.  
  9.  
  10.  
  11. Release 1.01
  12. ***********
  13.  
  14.     TDDD to Raw release 1.01 contains:
  15.  
  16.     TDDD_to_Raw.doc
  17.     TDDD_to_Raw.doc.info
  18.     3DRW.doc
  19.     3DRW.doc.info
  20.     TDDD_to_Raw1.01
  21.     TDDD_to_Raw1.01.info
  22.     TDDD_to_Raw.readme
  23.  
  24.  
  25. Copyright
  26. ********* 
  27.  
  28.  
  29.  
  30.         TDDD to Raw and the 3DRW file format are copyright 1995 by Jose M.
  31.  Arnesto.
  32.    
  33.      This release may be freely distributed as long as all the files 
  34.  listed above are included unchanged. The 3DRW file format may be freely 
  35.  used in any Amiga production, but its use on other platforms is prohibited.
  36.  
  37.     Please, if you like TDDD to Raw or the 3DRW format and use any of
  38.  them often, send me a postcard of your hometown. It is nice to hear about
  39.  Amiga mates out there. If you find a bug or have any suggestion, feel 
  40.  free to write to me:
  41.  
  42.  
  43.     Jose M. Arnesto
  44.     c/ Pando, 2-2ºA
  45.     39300 Torrelavega
  46.     Spain
  47.  
  48.     jarnesto@rigel.deusto.es    <- It rarely works.
  49.                    (Deusto University probably has the 
  50.                    worst Internet connection in the world)
  51.  
  52.  
  53.  
  54. Disclaimer
  55. ********** 
  56.  
  57.  
  58.  
  59.         The information in this manual and the TDDD to Raw program are 
  60.  provided "as is"  without warranty of  any  kind, either expressed or 
  61.  implied.  The entire  risk as to the accuracy of the information herein 
  62.  is assumed by you. 
  63.  
  64.     Jose M. Arnesto does  not warrant,  guarantee,  or  make any 
  65.  representations regarding the use of, misuse of, or the results of the use 
  66.  of, the information or the TDDD to Raw program  in  terms  of correctness, 
  67.  accuracy, reliability, currentness, or otherwise.  
  68.  
  69.  
  70.  
  71. Introduction
  72. ************
  73.  
  74.  
  75.      This idea began some months ago, when I was at the Southern Party 3 
  76.  and I  desperately needed a 3D editor to finish my demo. As I couldn't find
  77.  any, I decided to write this program so in the future I could use Imagine's 
  78.  editor to design the objects for my demos.
  79.  
  80.      TDDD to Raw was completely written in assembly with Devpac 3.02.
  81.  
  82.  
  83. What it does
  84. ************
  85.  
  86.  
  87.     TDDD to Raw is an utility to convert IFF-TDDD files, as used by
  88.  Imagine to store 3D objects, to a more suited format for demo makers, 3DRW. 
  89.      
  90.     It enables you to scale the objects and makes various checks of the 
  91.  integrity of that objects. It also sorts the points in the faces clock-wise
  92.  automatically, for use in light source routines.
  93.  
  94.       
  95. What You Need
  96. *************
  97.  
  98.  
  99.  
  100.     TDDD to Raw will run on any Amiga computer as long as it has
  101.  Kickstart 2.0 or later.
  102.  
  103.  
  104.  
  105. Using TDDD to Raw
  106. *****************
  107.  
  108.  
  109.  
  110.     I have tried to keep the interface as simple as possible, so I think
  111.  a brief description of the gadgets will be enough:
  112.  
  113.  Load:
  114.         
  115.         At first this will be the only active gadget. If you press 
  116.      it, a file requester will pop up, so you can choose the one you want 
  117.      to load.
  118.  
  119.  Objects panel:
  120.         
  121.         When you have loaded a file, this gadget will contain the 
  122.      list of the objects contained in it, arranged according to their 
  123.      hierarchy.
  124.      
  125.  Name:
  126.  
  127.         If you select an object from the objects panel, its name 
  128.      will appear here.
  129.      
  130.  Number of points:
  131.  
  132.         The number of points the selected object has.
  133.      
  134.  Number of faces:
  135.  
  136.         The number of faces the selected object has.
  137.  
  138.  Maximum coordinate:
  139.  
  140.         This gadget will contain the absolute maximum coordinate 
  141.      of the points in the object. It will vary according to the value 
  142.      of the scale.
  143.      
  144.  Scale:
  145.  
  146.         IFF-TDDD files store coordinates using 4 bytes, so the 
  147.      range of values goes from 2147483647 to -2147483648. 3DRW files 
  148.      only use 2 bytes for them, so an scale value must be applied.
  149.  
  150.         If you enter a positive value, all coordinates will be
  151.     multiplicated by that value and the maximum coordinate will vary
  152.     according to that.
  153.  
  154.         If you enter a negative value, all coordinates will be
  155.     divided by that value and the maximum coordinate will also vary.
  156.  
  157.  Save:
  158.  
  159.         This gadget will only be activated when you have selected
  160.      an object and the maximum coordinate is lower than 32768, that is,
  161.      the maximum signed value that fits in two bytes.
  162.  
  163.  
  164.      
  165. Messages
  166. ********
  167.  
  168.  
  169.  
  170.         This is an alphabetical list of the different messages TDDD 
  171.  to Raw will show. They are not error messages, as they will be listed later.
  172.     
  173.  
  174.  Are you sure you want to quit?:
  175.  
  176.         It will be appear when you have a file loaded and you click 
  177.      on the close gadget of the window. It you choose the cancel option,
  178.      you will not exit.
  179.  
  180.  File already exists:
  181.  
  182.         It will appear when you have chosen a name to save the file 
  183.      and another file already exists with the same name. If you press
  184.      replace, you will overwrite the previous file. If tou pick select,
  185.      you will be given the opportunity to choose a new name. If you
  186.      choose the cancel option, you will cancel the saving.
  187.  
  188.  Not an IFF file:
  189.  
  190.         The file you have loaded is not an IFF file, so no data will
  191.      be got from it.
  192.  
  193.  
  194.  Not an IFF TDDD file:
  195.  
  196.         The file you have loaded is IFF but not of the TDDD type. No
  197.      data will be got from it.
  198.  
  199.  Object not found:
  200.  
  201.         The file you have selected could not be found. You may have
  202.     mispelled the path or the name, or maybe it is locked by another 
  203.     application.
  204.  
  205.  This object is fragmented:
  206.  
  207.         The object you are about to save is fragmented, that is, it 
  208.      is composed of some sub-objects. 
  209.       
  210.  This object only has points:
  211.  
  212.         The object you are about to save does not have faces, only
  213.      points.
  214.  
  215.  Wrong face detected:
  216.  
  217.         TDDD to Raw has detected a malformed face. You can kill it
  218.      or cancel the saving.
  219.  
  220.  
  221.  
  222. Error Messages
  223. **************
  224.  
  225.  
  226.  
  227.     This is an alphabetical list of all the error messages along with a 
  228.  short description for every of them.
  229.  
  230.  Default screen is too small:
  231.  
  232.         The screen where TDDD to Raw is trying to open its window 
  233.      in is too small. Use the Screenmode program to make the Workbench
  234.      screen bigger or any utility to change the default screen to another
  235.      one.
  236.  
  237.  Not enough chip memory for scroll buffer:
  238.  
  239.         TDDD to Raw could not allocate enough chip memory for the  
  240.     buffer of the objects panel.
  241.  
  242.  Not enough memory for file:
  243.  
  244.         TDDD to Raw could not allocate enough memory for the buffer
  245.      to load the file in.
  246.  
  247.  Not enough memory for file buffer:
  248.  
  249.         TDDD to Raw could not allocate enough memory for the buffer
  250.      to save the file from.
  251.  
  252.  Not enough memory for file name:
  253.  
  254.         TDDD to Raw could not allocate enough memory to store the
  255.      name of the file.
  256.  
  257.  Not enough memory for gadget list:
  258.  
  259.         TDDD to Raw could not allocate enough memory to create the 
  260.      list of gadgets of the objects panel.
  261.  
  262.  Not enough memory for sorting buffer:
  263.  
  264.         TDDD to Raw could not allocate enough memory for the buffer
  265.      to sort the points in the faces. You will be given the chance of
  266.      cancelling or saving the file without ordering it.
  267.  
  268.  Not enough memory to analyze file:
  269.  
  270.         TDDD to Raw was able to load the file but could not allocate
  271.      enough memory for the different buffers that are required to analyze 
  272.      the file.
  273.  
  274.  TDDD to Raw requires Kickstart 2.0 or greater:
  275.  
  276.         TDDD to Raw requires version 2.0 (or above) of the operating
  277.      system.
  278.  
  279.  Unable to allocate the file requester:
  280.  
  281.         The program could not allocate the asl requester for you to
  282.      select the file you want.
  283.  
  284.  Unable to allocate FileInfoBlock:
  285.  
  286.         The program could not allocate the File Info Block to read
  287.      the length of the file you want to load.
  288.  
  289.  Unable to allocate tags:
  290.  
  291.         TDDD to Raw could not allocate the tags required for the
  292.      different requesters of the program.
  293.  
  294.  Unable to close file:
  295.  
  296.         The file was loaded or saved successfully but it could not
  297.      be closed.
  298.  
  299.  Unable to create gadtools context gadget:
  300.  
  301.         The program could not create the first gadget required for
  302.      the gadtools.
  303.  
  304.  Unable to create window gadgets:
  305.  
  306.         Some of the gadgets of the window could not be created.
  307.  
  308.  Unable to examine file:
  309.  
  310.         The file exists and has been locked, but the program has
  311.      not been able to examine it.
  312.  
  313.  Unable to lock default public screen:
  314.  
  315.         TDDD to Raw has not been able to lock the default public
  316.     screen to examine its characteristics. Perhaps another program has
  317.     it locked.
  318.  
  319.  Unable to open file:
  320.  
  321.         The file has been locked and examined, but the program has
  322.      not been able to open it.
  323.  
  324.  Unable to open the asl.library:
  325.  
  326.         TDDD to Raw could not open the asl.library. Check that the
  327.      file asl.library is in your libs: directory.
  328.  
  329.  Unable to open the dos.library:
  330.  
  331.         TDDD to Raw could not open the dos.library.
  332.  
  333.  Unable to open the gadtools.library:
  334.  
  335.         TDDD to Raw could not open the gadtools.library.
  336.  
  337.  Unable to open the main window:
  338.  
  339.         TDDD to Raw could not open its window.
  340.  
  341.  Unable to open the Topaz font:
  342.  
  343.         TDDD to Raw could not open the default system font, Topaz.
  344.  
  345.  Unable to open the utility.library:
  346.  
  347.         TDDD to Raw could not open the utility.library.
  348.  
  349.  Unable to read the file:
  350.  
  351.         The program has locked and open the file successfully, but 
  352.      it could not be read.
  353.  
  354.  Unable to read the whole file:
  355.  
  356.         The program has only been able to read a part of the file,
  357.      due to a read/write error, disk is full, etc.
  358.  
  359.  Unable to save file:
  360.  
  361.         The file was locked and opened, but TDDD to Raw could not 
  362.     save it.
  363.  
  364.  Unable to save the whole file:
  365.  
  366.         The program has only been able to save a part of the file,
  367.      due to a read/write error, disk is full, etc.
  368.  
  369.  
  370. History
  371. *******
  372.  
  373.  
  374.  Version 1.00: 
  375.  
  376.     March 1995: Never really released, just to a few friends.
  377.  
  378.  Version 1.01: 
  379.  
  380.     April 1995: First release. A lot of bugs fixed from version 1.00.